Adds a rectangle to a window’s update region.

OSStatus InvalWindowRect (
    WindowRef window, 
    const Rect *bounds
);

Parameter descriptions

window

A pointer to the window containing the rectangle that you wish to be updated.

bounds

Set this structure to specify, in local coordinates, a rectangle to be added to the window’s update region.

function result

A result code.

DISCUSSION

The InvalWindowRect function informs the Window Manager that an area of a window should be redrawn. The InvalWindowRect function is similar to the InvalRect function, but InvalWindowRect allows the window that it operates upon to be explicitly specified, instead of operating on the current graphics port, so InvalWindowRect does not require the graphics port to be set before its use.

See also the functions ValidWindowRect and InvalWindowRgn.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)